Version: 1.0.2

Add Card Holder with Non Primary Address

Create a card holder with an address which is different from the one that was provided while onboarding the customer.

Method: POST

{{URL}}/cardv2

Example

Payload Parameters

Parameters	Description
reference Optional	String Unique reference ID of the request Sample value: "visadps100001"
product Mandatory	String Name of the product associated with the card Sample value: "DEFAULT"
program Mandatory	String Name of the program to which the card product is mapped Sample value: "DEFAULT"
channel Mandatory	Enum Processing channel through which the card transaction happens Valid values: PULSE VISA_DPS Sample value: "VISA_DPS"
transactionType Mandatory	String Type of operation/transaction Constant value: "ADD_CARD_HOLDER_WITH_NON_PRIMARY_ADDRESS"
customerId Mandatory	String Unique Id of the customer Sample value: "100000000006001"
accountNumber Mandatory	String Account number of the customer Sample value: "400320588344662"
cardHolder Mandatory
firstName Mandatory	String First name of the account holder Sample value: "Matthew"
lastName Mandatory	String Last name of the account holder Sample value: "Sandra"
phoneNumber Mandatory	String Phone number of the account holder Sample value: "2562322420"
emailId Mandatory	String Email address of the account holder Sample value: "mathewsandra+1@gmail.com"
addressLine1 Mandatory	String First line of account holder's address Sample value: "3456W"
addressLine2 Mandatory	String Second line of account holder's address Sample value: "1st street"
city Mandatory	String City where account holder resides Sample value: "Kansus"
state Mandatory	String State where account holder resides Sample value: "KS"
zipCode Mandatory	String Zipcode of account holder's address Sample value: "56213"

Parameters

Description

reference

Optional

String

Unique reference ID of the request

Sample value: "visadps100001"

product

Mandatory

String

Name of the product associated with the card

Sample value: "DEFAULT"

program

Mandatory

String

Name of the program to which the card product is mapped

Sample value: "DEFAULT"

channel

Mandatory

Enum

Processing channel through which the card transaction

happens

Valid values:

PULSE

VISA_DPS

Sample value: "VISA_DPS"

transactionType

Mandatory

String

Type of operation/transaction

Constant value: "ADD_CARD_HOLDER_WITH_NON_PRIMARY_ADDRESS"

customerId

Mandatory

String

Unique Id of the customer

Sample value: "100000000006001"

accountNumber

Mandatory

String

Account number of the customer

Sample value: "400320588344662"

cardHolder

Mandatory

firstName

Mandatory

String

First name of the account holder

Sample value: "Matthew"

lastName

Mandatory

String

Last name of the account holder

Sample value: "Sandra"

phoneNumber

Mandatory

String

Phone number of the account holder

Sample value: "2562322420"

emailId

Mandatory

String

Email address of the account holder

Sample value: "mathewsandra+1@gmail.com"

addressLine1

Mandatory

String

First line of account holder's address

Sample value: "3456W"

addressLine2

Mandatory

String

Second line of account holder's address

Sample value: "1st street"

city

Mandatory

String

City where account holder resides

Sample value: "Kansus"

state

Mandatory

String

State where account holder resides

Sample value: "KS"

zipCode

Mandatory

String

Zipcode of account holder's address

Sample value: "56213"

cURL
C#
Go
NodeJs

curl --location --globoff '{{URL}}/cardv2' \
--header 'Content-Type: application/json' \
--data-raw '{"method":"ledger.CARD.request","id":"1","params":{"payload":{"reference":"visadps100001","product":"DEFAULT","program":"DEFAULT","channel":"VISA_DPS","transactionType":"ADD_CARD_HOLDER_WITH_NON_PRIMARY_ADDRESS","customerId":"100000000006001","accountNumber":"400320588344662","cardHolder":{"firstName":"Matthew","lastName":"Sandra","phoneNumber":"2562322420","emailId":"mathewsandra+1@gmail.com","addressLine1":"3456W","addressLine2":"1st street","city":"Kansus","state":"KS","zipCode":"56213"}},"api":{"signature":"{{signature}}","apiKey":"{{Api-key}}","credential":"{{cred}}"}}}'

var options = new RestClientOptions("{{URL}}/cardv2")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("", Method.Post);
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@"    ""method"": ""ledger.CARD.request"",
" + "\n" +
@"    ""id"": ""1"",
" + "\n" +
@"    ""params"": {
" + "\n" +
@"        ""payload"": {
" + "\n" +
@"            ""reference"": ""visadps100001"",
" + "\n" +
@"            ""product"": ""DEFAULT"",
" + "\n" +
@"            ""program"": ""DEFAULT"",
" + "\n" +
@"            ""channel"": ""VISA_DPS"",
" + "\n" +
@"            ""transactionType"": ""ADD_CARD_HOLDER_WITH_NON_PRIMARY_ADDRESS"",
" + "\n" +
@"            ""customerId"": ""100000000006001"",
" + "\n" +
@"            ""accountNumber"": ""400320588344662"",
" + "\n" +
@"            ""cardHolder"": {
" + "\n" +
@"                ""firstName"": ""Matthew"",
" + "\n" +
@"                ""lastName"": ""Sandra"",
" + "\n" +
@"                ""phoneNumber"": ""2562322420"",
" + "\n" +
@"                ""emailId"": ""mathewsandra+1@gmail.com"",
" + "\n" +
@"                ""addressLine1"": ""3456W"",
" + "\n" +
@"                ""addressLine2"": ""1st street"",
" + "\n" +
@"                ""city"": ""Kansus"",
" + "\n" +
@"                ""state"": ""KS"",
" + "\n" +
@"                ""zipCode"": ""56213""
" + "\n" +
@"            }
" + "\n" +
@"        },
" + "\n" +
@"        ""api"": {
" + "\n" +
@"            ""signature"": ""{{signature}}"",
" + "\n" +
@"            ""apiKey"": ""{{Api-key}}"",
" + "\n" +
@"            ""credential"": ""{{cred}}""
" + "\n" +
@"        }
" + "\n" +
@"    }
" + "\n" +
@"}";
request.AddStringBody(body, DataFormat.Json);
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "{{URL}}/cardv2"
  method := "POST"

  payload := strings.NewReader(`{`+"
"+`
    "method": "ledger.CARD.request",`+"
"+`
    "id": "1",`+"
"+`
    "params": {`+"
"+`
        "payload": {`+"
"+`
            "reference": "visadps100001",`+"
"+`
            "product": "DEFAULT",`+"
"+`
            "program": "DEFAULT",`+"
"+`
            "channel": "VISA_DPS",`+"
"+`
            "transactionType": "ADD_CARD_HOLDER_WITH_NON_PRIMARY_ADDRESS",`+"
"+`
            "customerId": "100000000006001",`+"
"+`
            "accountNumber": "400320588344662",`+"
"+`
            "cardHolder": {`+"
"+`
                "firstName": "Matthew",`+"
"+`
                "lastName": "Sandra",`+"
"+`
                "phoneNumber": "2562322420",`+"
"+`
                "emailId": "mathewsandra+1@gmail.com",`+"
"+`
                "addressLine1": "3456W",`+"
"+`
                "addressLine2": "1st street",`+"
"+`
                "city": "Kansus",`+"
"+`
                "state": "KS",`+"
"+`
                "zipCode": "56213"`+"
"+`
            }`+"
"+`
        },`+"
"+`
        "api": {`+"
"+`
            "signature": "{{signature}}",`+"
"+`
            "apiKey": "{{Api-key}}",`+"
"+`
            "credential": "{{cred}}"`+"
"+`
        }`+"
"+`
    }`+"
"+`
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'POST',
  'hostname': '{{URL}}',
  'path': '/cardv2',
  'headers': {
    'Content-Type': 'application/json'
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

var postData = JSON.stringify({
  "method": "ledger.CARD.request",
  "id": "1",
  "params": {
    "payload": {
      "reference": "visadps100001",
      "product": "DEFAULT",
      "program": "DEFAULT",
      "channel": "VISA_DPS",
      "transactionType": "ADD_CARD_HOLDER_WITH_NON_PRIMARY_ADDRESS",
      "customerId": "100000000006001",
      "accountNumber": "400320588344662",
      "cardHolder": {
        "firstName": "Matthew",
        "lastName": "Sandra",
        "phoneNumber": "2562322420",
        "emailId": "mathewsandra+1@gmail.com",
        "addressLine1": "3456W",
        "addressLine2": "1st street",
        "city": "Kansus",
        "state": "KS",
        "zipCode": "56213"
      }
    },
    "api": {
      "signature": "{{signature}}",
      "apiKey": "{{Api-key}}",
      "credential": "{{cred}}"
    }
  }
});

req.write(postData);

req.end();

Body

{
    "method": "ledger.CARD.request",
    "id": "1",
    "params": {
        "payload": {
            "reference": "visadps100001",
            "product": "DEFAULT",
            "program": "DEFAULT",
            "channel": "VISA_DPS",
            "transactionType": "ADD_CARD_HOLDER_WITH_NON_PRIMARY_ADDRESS",
            "customerId": "100000000006001",
            "accountNumber": "400320588344662",
            "cardHolder": {
                "firstName": "Matthew",
                "lastName": "Sandra",
                "phoneNumber": "2562322420",
                "emailId": "mathewsandra+1@gmail.com",
                "addressLine1": "3456W",
                "addressLine2": "1st street",
                "city": "Kansus",
                "state": "KS",
                "zipCode": "56213"
            }
        },
        "api": {
            "signature": "{{signature}}",
            "apiKey": "{{Api-key}}",
            "credential": "{{cred}}"
        }
    }
}
   

Response: 200

Response Parameters

Parameters	Description
id	String Response Id echoed from the request Id Sample value: " 1"
result	Object
cardHolderId	String Unique id of the card holder Sample value: " CH00000000020003"
api	Object
type	String Acknowledgement for type of operation requested for Constant value: " ADD_CARD_HOLDER_WITH_NON_PRIMARY_ADDRESS_ACK"
reference	String Auto generated reference ID of this acknowledgment Sample value: " REFvisadps100001"
dateCreated	Number Unix timestamp of the response was created Sample value: 1732085482
originalReference	String Original reference ID taken from the request Sample value: " visadps100001"

{
   "id": "1",
   "result": {
       "cardHolderId": "CH00000000020003",
       "api": {
           "type": "ADD_CARD_HOLDER_WITH_NON_PRIMARY_ADDRESS_ACK",
           "reference": "REFvisadps100001",
           "dateCreated": 1732085482,
           "originalReference": "visadps100001"
       }
   }
}

Add Card Holder with Non Primary Address

Method: POST​

Example​

Body​

Response: 200​

Method: POST

Example

Body

Response: 200